home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-1.iso / educate / smvga10e.zip / STORY.DOC < prev    next >
Text File  |  1995-12-18  |  22KB  |  599 lines

  1.           S T O R Y M A K E R + VGA
  2.                Version 1.0e
  3.            Copyright (c) 1992-1995
  4.             All rights reserved
  5.  
  6.                 Elson Embry
  7.             145 Plaza Drive #471
  8.        Vallejo, California 95491-3703
  9.  
  10.  
  11.            Phone: (707) 647-2258
  12.  
  13.      Internet Email Address: embryev@aol.com
  14.  
  15. ----------------------------------------------------
  16.         D O C U M E N T    S E C T I O N S
  17. ----------------------------------------------------
  18.  
  19.   A - Shareware File Descriptions
  20.   B - Program Description
  21.   C - Differences Between VGA and EGA Versions
  22.   D - Disclaimer/Warranty
  23.   E - Hardware Requirements
  24.   F - Copyright/Registration/Ordering Information
  25.   G - Initializing or Updating the Program
  26.   H - Running the Program
  27.   I - Data File Descriptions
  28.   J - Trademarks and Credits
  29.  
  30. -------------------------------
  31. A - SHAREWARE FILE DESCRIPTIONS
  32. -------------------------------
  33. Files contained in the current version:
  34.  
  35.  FILE_ID.DIZ  -  Shareware package description
  36.  README.1ST   -  Pre-installation text file
  37.  HISTORY.DOC  -  Log of program versions
  38.  VENDOR.DOC   -  Vendor information
  39.  STORY.DOC    -  Software information
  40.  REGISTER.FRM -  Registration form
  41.  SMVINIT.EXE  -  Initialization/update utility
  42.  STORY.EXE    -  Main program
  43.  HELP.DAT     -  Program file
  44.  PHONEME.DAT  -  Program file
  45.  PRULES.DAT   -  Program file
  46.  SBINST.DAT   -  Program file
  47.  SCREEN.DAT   -  Program file
  48.  SMR.DAT      -  Program file
  49.  SMFONTS.DAT  -  Program file
  50.  PHONEME.DCT  -  Program file
  51.  KIDS.SBK     -  Demo storybook
  52.  KIDS.SPL     -  Demo picture library
  53.  KIDS.SSL     -  Demo script file
  54.  JUNGLE.TXT   -  Demo text file
  55.  *.CMF        -  CMF FM files
  56.  *.SML        -  Melody files
  57.  *.VOC        -  Digital sound files
  58.  
  59. -----------------------
  60. B - PROGRAM DESCRIPTION
  61. -----------------------
  62. Storymaker+ VGA  is a  multimedia  kit for  creating
  63. interactive storybooks  with sound, music, and text-
  64. to-speech.  Storybooks of up to  99 screen pages can
  65. also be compiled into stand-alone, personalized pro-
  66. grams for easy  distribution  among friends, family,
  67. or for educational and commercial purposes.
  68.  
  69. The software is designed for the use of  elementary-
  70. school-aged  children as  a creativity and  learning
  71. tool for arts,music,reading and writing. Parents who
  72. are interested in participating  in the education of
  73. their younger children can also use it as a teaching
  74. tool.
  75.  
  76. Storymaker+ VGA  has  separate  editor  modules  for
  77. music,graphics,text and the designing and reading of
  78. storybooks. Children can use the Melody Maker,  with
  79. its animated piano, to explore music and sound;  the
  80. Scenery and Shape Editors with their  special tools,
  81. to explore shapes and colors;  the Book Editor  with
  82. its varied animation  tools, to do creative and log-
  83. ical thinking;  the Text Editor even with its simple
  84. features, to do  some writing and have some fun; the
  85. Book Reader to share their creations with others.
  86.  
  87. Other  users of the  program are  computer  learning
  88. centers and educational institutions which will find
  89. it useful as a teaching tool for reading, writing or
  90. multimedia  introduction.  Some unexpected  users of
  91. the EGA version are professionals who  find the pro-
  92. gram  useful as a  therapeutic  tool especially  for
  93. disabled children.
  94.  
  95. The Screen Keyboard interface, a new feature in Sto-
  96. rymaker+ VGA  will  also be of  special  interest to
  97. those who, because of a physical  handicap, can ope-
  98. rate a computer  only through a device that emulates
  99. a mouse.  By pointing  and clicking at the interface
  100. keyboard diagram on the screen  through the emulator
  101. device, a user may enter text without using the com-
  102. puter keyboard.
  103.  
  104. Writers  of children's  books may also be interested
  105. to use the program as a low-cost, simple  multimedia
  106. authoring  system.  Storybooks  may  be  distributed
  107. royalty-free  with  no further arrangement  with the
  108. author.
  109.  
  110. Online help is available throughout the program. The
  111. help  screens may also be saved  into a special file
  112. that can be viewed or printed.
  113.  
  114. --------------------------------------------
  115. C - DIFFERENCES BETWEEN EGA AND VGA VERSIONS
  116. --------------------------------------------
  117. Storymaker+ comes in two versions, the original Sto-
  118. rymaker+ which runs only in the  EGA graphics  mode,
  119. and Storymaker+ VGA, which runs only in VGA mode.
  120.  
  121. Although most  of the VGA version features came dir-
  122. ectly  from the development of the EGA version,  the
  123. two versions should be treated as two different pro-
  124. grams. You should not install Storymaker+ VGA in the
  125. same directory as the EGA version - or the other way
  126. around - to ensure that files that  are incompatible
  127. with either version do not cause a problem when run-
  128. ning the program.   This will also  prevent any con-
  129. fusion when updating either version later.
  130.  
  131. If you want to  keep only  one version,  for example
  132. the  VGA version,  but want  to use files created in
  133. the EGA version that the VGA version will accept, it
  134. is  recommended that  you copy or move the valid EGA
  135. files  into  the  VGA data  directories, rather than
  136. atttempt to  install the VGA version in the EGA pro-
  137. gram directory.
  138.  
  139. As for file compatibility,  currently  both the  EGA
  140. and VGA versions use the same file format for Melody
  141. Maker's SML files and  the  Text Editor's TXT  files
  142. and  so any  of these  files  can be used in  either
  143. version.
  144.  
  145. In  addition,  Storymaker+ VGA's  editors  will load
  146. graphics  from the  EGA version's  SPL libraries. It
  147. will not  however save graphics into an  EGA library
  148. file,only into a VGA library file. Also an important
  149. to keep in mind if you  have or  plan to  create VGA
  150. storybooks using graphics directly from EGA  library
  151. files:  you must keep  the EGA library files  in the
  152. VGA GRAPHIC directory in order to avoid missing pic-
  153. ture errors as storybook's graphics are  loaded only
  154. from the original library files.
  155.  
  156. Storybooks  created  in one version  can not be read
  157. nor  edited in the other version.
  158.  
  159. -----------------------
  160. D - DISCLAIMER/WARRANTY
  161. -----------------------
  162. Sorry about the following legal stuff:
  163.  
  164. THE SOFTWARE  IS PROVIDED  ON AN "AS-IS"  BASIS  AND
  165. THERE IS  NO WARRANTY OF ANY KIND, WHETHER EXPRESSED
  166. OR IMPLIED.  YOUR USE  OF THE SOFTWARE IS COMPLETELY
  167. AT YOUR OWN RISK.  I ASSUME NO LIABILITY FOR ANY DA-
  168. MAGES CAUSED  BY THE  DIRECT OR INDIRECT USE  OF THE
  169. SOFTWARE AND ANY OF ITS FILES. YOUR USE OF THE SOFT-
  170. WARE MEANS THAT YOU AGREE TO ALL OF THESE TERMS.
  171.  
  172. -------------------------
  173. E - HARDWARE REQUIREMENTS
  174. -------------------------
  175. IBM  or  compatible  computer, 640K RAM memory, hard
  176. drive, VGA graphics monitor,  mouse device.  A Sound
  177. Blaster  compatible  sound card is  required for all
  178. sound effects.
  179.  
  180. ------------------------------------------------
  181. F - COPYRIGHT/SHAREWARE AND ORDERING INFORMATION
  182. ------------------------------------------------
  183. Storymaker+ VGA is  copyrighted  by the author.  All
  184. rights are reserved.
  185.  
  186. Storymaker+ VGA is distributed as shareware, a try-
  187. before-you-buy method of marketing software. Payment
  188. of  registration fee is required if you want to con-
  189. tinue using the program after trying it.  The fee is
  190. to  compensate the program's author for the product.
  191. If you find Storymaker+ valuable and like the share-
  192. ware  method of testing  software, the author  needs
  193. your support to continue making improvements  and to
  194. write new educational programs.
  195.  
  196. Any author's income  comes only from users register-
  197. ing the  program and not from any payment  you might
  198. have  made for the  shareware  version as  no income
  199. arrangements are made with shareware distributors.
  200.  
  201. The registration fee is $26 U.S. dollars. There is a
  202. handling/mailing charge  of $3.00  ($6.00 for orders
  203. outside the United States,Canada and Mexico). Checks
  204. from  foreign countries must be drawn against a U.S.
  205. bank.  California residents,  please add the applic-
  206. able sales tax.
  207.  
  208. Please call or write  for site licenses, school dis-
  209. counts and quantity discounts.
  210.  
  211. To order Storymaker+ VGA  by mail,  please print the
  212. file REGISTER.FRM.
  213.  
  214. If you are a Compuserve  member,  to register online
  215. through  Compuserve:    GO SWREG,   then  follow the
  216. prompts. Storymaker product ID number is 4782.
  217.  
  218. By a special arrangement, you can also order by cre-
  219. dit card from  Public (software) Library  with  your
  220. MC, Visa, AmEx  or  Discover  card  by calling  800-
  221. 242-4775  (from overseas:  713-524-6394),  or by FAX
  222. to 713-524-6398, or by CompuServe to 71355,470.  Ask
  223. for item# 11139, Storymaker+ VGA version. These num-
  224. bers are  for ordering  only.  The program's  author
  225. can not reached  at these  numbers.  To  contact the
  226. author about site licensing, quantity discount, pro-
  227. duct shipment status, or for anything other  than to
  228. place a credit card order, please call 707-647-2258,
  229. or by Internet email to  embryev@aol.com.   Or write
  230. to:
  231.  
  232.    Elson Embry
  233.    145 Plaza Drive #471
  234.    Vallejo,  California  94591-3703
  235.  
  236. Shareware distribution of  Storymaker+ VGA to others
  237. is permitted and encouraged as long as all files are
  238. included and no file is altered in any  way.  BBS's,
  239. vendors or anyone planning to distribute Storymaker+
  240. VGA for a fee, please refer  to the file  VENDOR.DOC
  241. for distribution requirements and restrictions.
  242.  
  243. ----------------------------------------
  244. G - INITIALIZING OR UPDATING THE PROGRAM
  245. ----------------------------------------
  246. IF YOU HAVE AN  EGA VERSION  OF THE PROGRAM,  PLEASE
  247. READ FIRST  THE SECTION ON  THE  DIFFERENCES BETWEEN
  248. THE  EGA AND VGA VERSIONS BEFORE  INSTALLING THE VGA
  249. VERSION.
  250.  
  251. If you already have an older version of the program,
  252. change the current directory to the Storymaker+ home
  253. directory. If not,then you need to create a separate
  254. directory for the program in your hard disk.
  255. For example:
  256.     C:
  257.     MD \SMVGA      (Creates the directory)
  258.     CD \SMVGA      (Changes the current directory)
  259.  
  260. Next,  copy all files to the  directory, then uncom-
  261. press any archived files.
  262. From example:
  263.     COPY A:*.*
  264.     Then Use your decompression software if needed.
  265.  
  266. Next, run the initialization utility SMVINIT.EXE.
  267. From example:
  268.     SMVINIT
  269.  
  270. The  utility checks  for Storymaker+'s VGA data sub-
  271. directories,creates the subdirectories if necessary,
  272. then transfers all new data files to their director-
  273. ies.
  274.  
  275. If you  are updating  an older version, the  utility
  276. also makes sure the setup file structure is  current
  277. by reinitializing  it to its  default configuration.
  278.  
  279. -----------------------
  280. H - RUNNING THE PROGRAM
  281. -----------------------
  282. Storymaker+ VGA is written to run under the DOS ope-
  283. rating system.  It is not designed  to run under the
  284. Microsoft  Windows  environment and will likely  run
  285. erratically because of Windows use of shared resour-
  286. ces.  But if you do need  to run it  under  Windows,
  287. try assigning the program  as much control as possi-
  288. ble  for  best  results.
  289.  
  290. If Storymaker+ is  configured for the  Sound Blaster
  291. card, the  program looks for the Sound Blaster envi-
  292. ronment variable BLASTER.  This is normally added to
  293. the  AUTOEXEC.BAT in the  root directory  to specify
  294. the  current  Sound Blaster  hardware configuration.
  295. The command  for setting  the environment string has
  296. the form:
  297.  
  298.     SET BLASTER=Appp Ii Dd Tt
  299.     where:
  300.        ppp = Base I/O port
  301.        i   = IRQ number
  302.        d   = DMA channel
  303.        t   = Sound Blaster card version number
  304.  
  305.     Example:  SET BLASTER=A220 I7 D1 T1
  306.  
  307. If  no environment string  is found, Storymaker+ VGA
  308. attempts to auto detect the card using base I/O port
  309. 220h and IRQ 7 as default settings. It is preferable
  310. though that the BLASTER environment be used to avoid
  311. port problems that may cause the system to hang up.
  312.  
  313. If you will be playing CMF files,the CMF file player
  314. SBFMDRV.COM  must also  be in memory  before running
  315. Storymaker+.
  316.  
  317. Please refer  to your Sound Blaster manual  for more
  318. instructions on the  BLASTER environment strings and
  319. the SBFMDRV.COM driver.
  320.  
  321. To run Storymaker+, change the directory to its home
  322. directory. The command line format is:
  323.  
  324.     STORY [/UNLOCK] [/READ file] [/BOOK] [/SPV file]
  325.  
  326. Entries inside the brackets are command switches and
  327. are optional. Filename  extensions  are not required
  328. in the filenames. The command switches are:
  329.  
  330.   /UNLOCK
  331.      Also accepts short form  /U.  This unlocks  all
  332.      utilities in the Utility menu. The program does
  333.      not allow access to some utilities  unless this
  334.      command switch is invoked.
  335.  
  336.   /READ file
  337.      Space optional.Also accepts short form /R file.
  338.      This reads the storybook file <file> automatic-
  339.      ally. It skips the main menu and opens the Book
  340.      Reader to read a storybook  in computer-help-me
  341.      mode. The command is to enable a young child to
  342.      use the  program just to  read a story.  Repeat
  343.      the command  to read more than  one file in one
  344.      session.
  345.  
  346.   /BOOK
  347.      Also accepts short form  /B.
  348.      This  bypasses the main menu and  allows access
  349.      only to the Book Reader. The command is to ena-
  350.      ble a young child to read storybooks only while
  351.      using the program.
  352.  
  353.   /SPV file
  354.      Space optional.
  355.      This  loads  the Voicemaker SPV  phoneme  sound
  356.      file <file> in place of  Storymaker+'s  phoneme
  357.      sounds. A phoneme sound file contains the digi-
  358.      tal speech data used by the program to make the
  359.      computer talk.  An  SPV file is created through
  360.      Voicemaker, a freeware speech program that also
  361.      allows the user to record the phoneme's in  his
  362.      or her own voice and can be used as a companion
  363.      program  to Storymaker+.
  364.  
  365.      Voicemaker SPV files  must be located in Story-
  366.      maker+ home directory before it can be accessed
  367.      by Storymaker+.
  368.  
  369.  
  370. Below are some examples of running the program:
  371.  
  372.      STORY
  373.      Runs the  program but  does not allow access to
  374.      some of the utilities.
  375.  
  376.      STORY /UNLOCK
  377.      Runs the program allowing access  to all of the
  378.      utilities.
  379.  
  380.      STORY /BOOK
  381.      Restricts access to the Book Reader.  This pre-
  382.      vents  changing of  data files  and is intended
  383.      for young children using the program.
  384.  
  385.      STORY /READ demo /READ vacation
  386.      Reads the storybook file  DEMO.  Reads the book
  387.      file  VACATION  next.  Terminates program  when
  388.      done.
  389.  
  390.      STORY /READ demo /BOOK
  391.      Reads the book file DEMO.Then continues running
  392.      the program but allows access only  to the Book
  393.      Reader.
  394.  
  395.      STORY /SPV RICHARD
  396.      Loads  Voicemaker's file RICHARD.SPV  (recorded
  397.      Richard?),  and uses  it as the  text-to-speech
  398.      player's voice.
  399.  
  400. --------------------------
  401. I - DATA FILE DESCRIPTIONS
  402. --------------------------
  403. This section  describes  Storymaker+ VGA data files.
  404.  
  405. 1 - Picture Library Files
  406.  
  407. A picture library contains the pictures for the sce-
  408. neries and animation shapes of a Storymaker+  story-
  409. book.  A library file  is created in either the Sce-
  410. nery  Editor or Shape Editor  module of the  program
  411. and pictures are added to a library  by using either
  412. graphics editor.  Library files  are located  in the
  413. program  subdirectory  GRAPHICS  and carry the  file
  414. extension SPL.
  415.  
  416. When saving a picture in a library file, Storymaker+
  417. assigns an index number to it. The  index number and
  418. library filename are used when adding the picture in
  419. a  storybook. To avoid  missing picture errors  when
  420. loading storybooks,it is important to understand how
  421. pictures are saved in a storybook file.
  422.  
  423. When  designing a storybook  in the Book Editor, the
  424. user selects which  picture  library to use from the
  425. available library files. If the selected library has
  426. not been used in the storybook,the Book Editor saves
  427. the  library name in an indexed list it maintains in
  428. the storybook file.  When the user adds a picture to
  429. the story, only the  picture's  index number and the
  430. library's index  number  are saved  to reference the
  431. picture selected.  The picture data, picture name or
  432. or description are not saved.
  433.  
  434. When the Book Editor or Book Reader reads a page  of
  435. the storybook, it uses the library's indexed name in
  436. the library list and then accesses the picture  data
  437. itself  through  the picture's  index number  in the
  438. library file - it does not check  nor use in any way
  439. the  picture's  name  or description,  only that the
  440. library exists and the picture's index number valid.
  441. If it can not load  a picture,  the program beeps to
  442. signal an error and loads a special internal picture
  443. in place of the missing picture.
  444.  
  445. A picture that  has been accidentally  deleted  from
  446. its library  file therefore can not be restored in a
  447. story  by simply  saving a  new picture  in the same
  448. library under the same name,  since the  new picture
  449. will most most  likely get a different index number.
  450. It can be restored only by additionally  editing the
  451. storybook  to delete every occurence of  the deleted
  452. picture  and  then recreating  the animation  script
  453. under the new picture. Otherwise,  a missing picture
  454. error will continue to appear or worse, a wrong pic-
  455. ture  will show up in a story if the index number of
  456. the  deleted picture  has been  reassigned  to a new
  457. picture.
  458.  
  459.  
  460. 2 - Melody Files
  461.  
  462. Melody files are located in the program subdirectory
  463. MELODY  and carry the  file extension SML.  Melodies
  464. are entered in the program module Melody Maker.
  465.  
  466. The Book Editor adds a melody to a storybook by sav-
  467. ing the melody's filename -  actual data  are copied
  468. only in the run-time file.
  469.  
  470.  
  471. 3 - Text Files
  472.  
  473. A text file  adds sound effects to a story when read
  474. by the text-to-speech player.
  475.  
  476. Text files  are located  in the program subdirectory
  477. TEXT  and carry the file extension TXT.  A screenful
  478. of text may be  entered  in the Text Editor  module.
  479. Storymaker+ also  accepts  larger  files from  other
  480. editors,  although  these  can not be edited  in the
  481. Text Editor; copy the files into the TEXT directory.
  482.  
  483. The Book Editor  adds a text file  to a storybook by
  484. saving its filename - actual data are copied only in
  485. the run-time file.
  486.  
  487.  
  488. 4 - Digitized Sound Files
  489.  
  490. Digitized sound files add sound effects  to a story-
  491. storybook when played by the digital sound player.
  492.  
  493. Sound files are located in the program  subdirectory
  494. SOUNDS and carry the file extension VOC.  Sources of
  495. digitized  sounds are  BBS's and  shareware vendors.
  496. You  can also  record  your own with your sound card
  497. and a microphone.
  498.  
  499. Currently, Storymaker+ will play sounds files  saved
  500. under  Sound Blaster's  8-bit  unpacked  VOC format.
  501. Files that  do not  the Sound Blaster's  VOC  header
  502. will be  played  as 8-bit  raw data, 8000hz sampling
  503. rate.
  504.  
  505. Storymaker+ saves a digitized sound file to a story-
  506. book by saving its filename - actual data are copied
  507. only in the run-time file.
  508.  
  509.  
  510. 5 - FM Music Files
  511.  
  512. Another type of  sound effects that  can be added to
  513. a storybook are Sound  Blaster CMF music files.  CMF
  514. files are FM synthesized  music files  with up to 11
  515. musical instruments. You need the CMF player utility
  516. SBFMDRV.COM to play these files under Storymaker+.
  517.  
  518. Storymaker+ as distributed has a few CMF files;among
  519. sources  of CMF files  are BBS boards  and shareware
  520. vendors.  Copy the files into Storymaker+ subdirect-
  521. ory FMMUSIC.
  522.  
  523. The  Books Editor  adds a CMF music file in a story-
  524. book by saving its filename - actual data are copied
  525. only in the run-time file.
  526.  
  527.  
  528. 6 - Storybook Data and Run-time Files
  529.  
  530. Storybooks are created in the Book Editor module and
  531. saved cin the program csubdirectory BOOKS. The files
  532. carry the file extension SBK.
  533.  
  534. A storybook can also be compiled into a run-time EXE
  535. file which is an executable program that will run by
  536. itself even in a floppy disk.
  537.  
  538. A run-time file is created by compiling all the data
  539. used in a storybook  and  Storymaker+ reader program
  540. into a single file.  The EXE  storybook  has its own
  541. screen book cover that can be personalized and other
  542. special options that are not normally available when
  543. reading the  book  through  the main program's  Book
  544. Reader.
  545.  
  546. A very important  thing to keep in mind:  a run-time
  547. file is not editable - it is for reading books only,
  548. so you should keep the original files if you want to
  549. retain  the capability to make changes in the story-
  550. book.
  551.  
  552.  
  553. 7.  Script Files
  554.  
  555. Script files  are object animation files  created in
  556. the Book Editor module and are saved  in the program
  557. subdirectory SCRIPTS.  The files carry the file ext-
  558. ension SSL.
  559.  
  560.  
  561. 8.  PCX Files
  562.  
  563. PCX files  are standard graphics  files  saved under
  564. the  PCX format and  carries the file extension PCX.
  565. As the PCX file format  is supported  by most stand-
  566. ard graphics  editor,  Storymaker+ VGA  includes the
  567. capability to export graphics from the graphics edi-
  568. tor and  Book Editor into PCX format for use,  edit-
  569. ing or printing in other applications. Exported gra-
  570. phics are saved in Storymaker+ library PCX.
  571.  
  572. Storymaker+ VGA  also has the  capability to  import
  573. into  its graphics  editor  PCX files  created  from
  574. other application. You can import PCX files from any
  575. directory  in the current drive.  You also  have the
  576. option  of capturing  any  portion  of a PCX  in its
  577. actual size or scaled-down size if necessary.
  578.  
  579. ------------------------
  580. J - TRADEMARKS & CREDITS
  581. ------------------------
  582. The sample storybook  Kids,Kids,Kids including  most
  583. of its  graphics, the  main part of the  Storymaker+
  584. VGA's title  screen, the  run-time  BookReader cover
  585. screens,  the caption boxes in the Book Editor,  and
  586. the better-looking  picture icons  were  provided by
  587. Loraine Wauer.  Loraine is  the author of Billy Bear
  588. Storybooks,a series of children's storybooks created
  589. through Storymaker+.
  590.  
  591. The CMF files distributed  with the program are pub-
  592. lic domain files.
  593.  
  594. IBM is  registered trademark of the IBM Corporation.
  595. Microsoft  and   Microsoft  Windows  are  registered
  596. trademark  and trademark  respectively of  Microsoft
  597. Corporation. Sound Blaster is a registered trademark
  598. of Creative Labs,Inc.
  599.